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TECHNICAL INFORMATION 



APPENDIX A / Error Messages 


There are three kinds of error messages you might get while 
using your Computer: 

. Boot Errors, such as "BOOT ERROR DC." See the 
BOOT ERRORS TABLE for more information. 

. Operating System Errors, such as "ERROR 24" or 
"FILE NOT FOUND." To get a brief description of 
a numbered error, type "ERROR" followed by the 
error number displayed. For example, type: 

ERROR 31 <ENTER> 

and your screen will show: 

PROGRAM NOT FOUND 

For more information, see the SYSTEM ERRORS TABLE. 

. Application Program Errors — see your 
application program manual. 


When an error message is displayed: 

. Try the operation several times. 

. Look up boot errors and operating system errors in 
the following tables and take the recommended 
actions. See your application program manual for 
explanations of application program errors. 

. Try using other diskettes. 

. Reset the Computer and try the operation again. 

. Check all the power connections. 

. Check all interconnections. 

. Remove all diskettes from drives, turn off the 
Computer, wait 15 seconds, and turn it on again. 

. If you try all these remedies and still get an 
error message, contact a Radio Shack Service 
Center. 

Note: If there is more than one thing wrong, the 

Computer might wait until you correct the first error 
before displaying the second error message. 

RSSC = Radio Shack Service Center 
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® 


SYSTEM ERRORS TABLE 


Error 

Code 

Description 

Explanation/Action 

6 

Attempt to open a 
file which hasn't 
been closed. 

Close file before 
re-opening. 

28 

Attempt to read 
past end of file. 

Record Number specified 
is past the EOF. 

34 

Attempt to use a non 
program file as a 
program. 

File specified for 
execution is not a 
program file or an 
illegal load address 
was given. 

133 

Bad CRT number. 

For multi-user only. 

1 

Bad function code 
on SVC call or no 
function exists. 

Check function code 
number used on an 

SVC call. 

132 

Bad partition number. 

For multi-user only. 

129 

Bad SVC-Block 
format. 

Check format of SVC-block 
for errors. 


BOOT ERROR 

See BOOT ERROR TABLE 

4 

CRC error during 
disk I/O 
(input/output) 
operation. 

Try operation again, 
using a different 
diskette. If problem 
occurs frequently call 
RSSC. 

2 

Character not 
available. 

No record or character 
was available when the 

SVC was called. 

16 

DCB is modified and 
is unusable. 

DCB (used in machine- 
language programming) has 
been modified since last 


disk access (while the 
file was open). 
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Error 

Code 

Description 

Explanation/Action 

41 

Data lost during disk 
I/O (input/output). 
Hardware fault. 

Contact a Radio Shack 
Service Center. 

135 

Debug Not Configured. 

Include Debug at 
configuration time. 

136 

Device not available. 

Device already assigned 
For multi-user only. 

137 

Device Unassigned. 

For multi-user only. 

17 

Directory read error. 

Error occured while 
trying to read directory. 
Use a different diskette. 

26 

Directory space 
full. 

Number of filenames 
exceed the amount set 
when diskette was 
formatted. 

18 

Directory write error. 

Error occured while 
trying to write to the 
directory. Use a 
different diskette. 

33 

Disk space 
allocation can't be 
made because of 
fragmentation of 
space. 

(not used on 

TRSDOS-II) 

Use a different diskette 
or copy files to a clean 
diskette to reduce 
fragmentation. 

27 

Disk space full. 

No available space on 
diskette. 

8 

Disk drive not ready. 

Drive door open or 
diskette not in drive. 

On thinline drives, use 
TRSDOS-II, TRSDOS-16, or 
patched version of 

- 

========================== 

TRSDOS 2.0b. 
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Error 

Code 

Description 

Explanation/Action 

15 

Disk is write 
protected. 

Use a diskette with a 
write-enable tab on it. 

5 

Disk sector not 
found. 

Try a different diskette. 

128 

DO-Nesting not 
allowed. 

A 'DO' command was 
encountered within a 

DO file. 

25 

File access denied 
due to password 
protection. 

Incorrect password given 
for protection level — 
See ATTRIB in the Model 

16 Owner's Manual. 

11 

File already in 
directory. 

Filename already exists 
as a directory entry. 

Kill existing file or 
choose another filename. 

24 

File not found. 

Filename given not found 
on available diskettes 
or file is incorrect type 
for desired operation. 

49 

Hardware fault 
during disk I/O 
(input/output). 

Contact a Radio Shack 
Service Center. 

38 

I/O (input/output) 
attempt to an unopen 
file. 

Open file before access. 

39 

Illegal I/O 
(input/output) 
attempt. 

On Thinline drives — 
use patched version of 
TRSDOS. Can be caused 
by an I/O attempt to a 
differently formatted 
diskette. Format 
diskette under current 
version of TRSDOS or 
use FCOPY. 


Radie/haek 8 


224 

















TRSDOS 16 OWNER'S MANUAL 


TRS-80 


TECHNICAL INFORMATION 


Error 

Code 

Description 

Explanation/Action 

131 

Illegal Address. 

SVC block or SVC 
argument is not within 
the memory range. 

138 

Illegal device name. 

Device name specified for 
ASSIGN not valid. 

7 

Illegal disk change. 

The system detected 
an illegal disk swap. 

144 

Illegal File Type 

File type used is not 
the type required by the 
system (VLR or FLR). 

134 

Illegal operation 

For multi-user only. 

19 

Improper file name 
(filespec). 

Filespec given does not 
meet TRSDOS standard file 
specifications. 

48 

Incorrect command 
parameter. 

Option or argument given 
in command is incorrect. 

9 

Invalid data 
provided by caller. 

Data stream to be 
processed has illegal 
characters. 

50 

Invalid Space 

Descriptor. 

Try a different diskette. 

10 

Maximum of 16 files 
may be open at once. 

Too many files opened at 
one time. 

35 

Memory fault during 
program load. 

Program not loaded 
correctly, possibly be¬ 
cause of faulty memory or 
because a bad load 
address was given. 

12 

No drive available 
for an open. 

No on-line drive is: 

a) write enabled or 

b) has enough space to 
create a new file. 


Radio /hack 


225 




















TRSDOS 16 OWNER'S MANUAL 


TRS-80 


TECHNICAL INFORMATION 


® 


Error 

Code 

Description 

Explanation/Action 

0 

No error found. 

No error occurred. 

30 

No more extents 
available (16 
maximum). 

(not used on 

TRSDOS-II) 

Data on diskette too 
fragmented, copy files 
to a clean diskette. 

46 

Not applicable to 

VLR type files. 

Operation performed not 
valid for VLR files. 

20 

Not Used. 


21 

Not Used. 


22 

Not Used. 


23 

Not Used. 


130 

Odd address. 

Address required by SVC 
block must be even. 

37 

Open attempt for a 
file already open. 

File specified for open 
is already open. 

3 

Parameter error on 
call. 

Parameter incorrect or 
required parameter 
(option) missing. 

36 

Parameter for open 
is incorrect. 

Check OPEN statements or 
DCB for errors. 

31 

Program not found. 

Program specified not 
found on available 
volumes. 

44 

Printer fault (may 
be turned OFF). 

Check connections, power, 
ribbon, etc. 

45 

Printer not 
available. 

Check connections, power, 
ribbon, etc. 
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Error 

Code 

Description 

Explanation/Action 

42 

Printer not ready. 

Check connections, power, 
ribbon, etc. 

43 

Printer out of 
paper. 

Check printer's paper 
supply. 

29 

Read attempt outside 
of file limits. 

Use valid record numbers. 

47 

Required command 
parameter not found. 

Required option or 
argument missing in 
command. 

40 

SEEK error. 

Data cannot be read from 
diskette — faulty media. 
Try a different diskette. 

140 

Undefined 


141 

Undefined 


142 

Undefined 


32 

Unknown drive 
number (filespec). 

Drive number specified 
not a valid drive number. 

51-127 

Unknown Error Codes. 


139 

User Stack 

Overflow 

Overflow occured in user 
stack during SETBRK SVC 
or SETTRP SVC operation. 

13 

Write attempt to a 
read only file. 

File was opened for read 
only, not read/write. 

14 

Write fault on disk 

I/O (input/output). 

Error occurred during 
a write operation — try 
a different diskette. If 
problem continues - RSSC. 

143 

SVC Table Overflow 

For multi-user only. 


Radn/haek 8 


227 






















TRSDOS 16 OWNER'S MANUAL 


TECHNICAL INFORMATION 


BOOT ERROR TABLE 


Error Description EXplanation/Action 

Code 


BOOT 

ERROR 

II 

II 

II 

II 

II 

II 

II 

II K 
II o 

II 

Defective ROM 

Contact a Radio 




(Checksum Error) 

Shack Service Center 

BOOT 

ERROR 

CT 

Defective CTC 

Contact a Radio 




Chip 

Shack Service Center 

BOOT 

ERROR 

DC 

1. Defective 

1. Try a different 




diskette. 

diskette. 




2. Floppy disk 

2. Turn on floppy 




expansion unit 

disk expansion 




not on. 

unit. 




3. Defective FDC 

3. Contact a Radio 




Chip or Drive. 

Shack Service 
Center. 

BOOT 

ERROR 

DM 

Defective DMA 

Contact a Radio 




Chip 

Shack Service Center 

BOOT 

ERROR 

DJ3 

Drive not ready. 

1. Improperly 

1. Insert diskette 




inserted 

again and reset 




diskette. 

the Computer. 




2. Defective 

2. Try a different 




diskette. 

diskette. 




3. Defective drive. 

3. Contact a Radio 





Shack Service 
Center. 

BOOT 

ERROR 

HA 

Controller Error. 

Re-initialize hard 




Aborted command: 

disk or contact a 




Problem during 

Radio Shack Service 




boot-up of hard 
disk. 

Center. 

BOOT 

ERROR 

HC 

CRC Error. 

Re-initialize hard 




Invalid data in 

disk or contact a 




data field. 

Radio Shack Service 
Center. 
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Error 

Code 


Description 

Explanation/Action 

BOOT 

ERROR 

HD 

Controller Error. 

Re-initialize hard 




Busy not reset. 

disk or contact a 
Radio Shack Service 
Center. 

BOOT 

ERROR 

HI 

CRC Error. 

Re-initialize hard 




Invalid data in 

ID field. 

disk. 

BOOT 

ERROR 

HM 

Data address 

Re-initialize 




mark not found. 

hard disk 

BOOT 

ERROR 

HN 

ID not found. 

Re-initialize 




No Boot Track. 

hard disk 

BOOT 

ERROR 

H0 

Track 0 Error 
on hard disk 

1. Didn't find 

1. Reset the 




Track 0 before 
time-out. 

Computer 




2. Secondary hard 

2. Turn on your 




disk drives 

secondary hard 




not turned on 

disk drives 

BOOT 

ERROR 

HT 

Time-out while 



waiting for READY. 
1. Hard disk drive 
not powered up. 


2. Hard Disk Drive 2, 
isn't turned ON 
and ready within 
10 seconds after 
Computer. 

3. Hard Disk Drive 3, 
is disconnected. 


Follow correct 
power up 
procedure: turn 
on hard disk 
first. 

Reset the 
Computer 


Connect the hard 
disk drive or 
operate under 
floppy disk 
control 
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Error 

Code 



Description 

Explanation/Action 

BOOT 

ERROR 

LD 

Lost Data during 

Try another TRSDOS 




read — FDC 

diskette or contact 




(Floppy Disk 

a Radio Shack 




Controller) or 

Service Center. 




Drive fault. 


BOOT 

ERROR 

MF 

Defective RAM in 

Contact a Radio 




address range 

Shack Service 




H'1000'-H'7FFF'. 

Center. 

BOOT 

ERROR 

MH 

Defective RAM in 

Contact a Radio 




address range 

Shack Service 




H'8000'-H'FFFF'. 

Center. 




(64K Computers only) 

BOOT 

ERROR 

ML 

Defective RAM in 

RSSC 




address range 





H•0000'-H'0FFF'. 


BOOT 

ERROR 

PI 

Defective PIO 

RSSC 




Chip 


BOOT 

ERROR 

RS 

The diskette 

1. Insert a TRSDOS, 




in Drive 0 is 

TRSDOS-II or 




not Radio Shack 

TRSDOS-16 




Model 16 or 

formatted 




Model II 

diskette into 




Operating System 

Drive 0 and 




format. 

reset the 


Computer. 

2. Remove diskettes 
and turn power 
off. Wait 15 
seconds and turn 
on the system 
again. 


BOOT ERROR SC CRC Error. Try a different 

Invalid data on diskette, 

diskette or 
defective diskette. 
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Error 

Code 

Description 

Explanation/Action 

BOOT ERROR TK 

Record not found 
on bootstrap 
track. Improperly 
formatted or 
defective 
diskette. 

Re-format your 
diskette or try a 
different diskette. 

BOOT ERROR Z8 

Defective CPU. 

RSSC. 

(68000 Memory 

Fault at Page 
Address=xxxxxxx) 

Memory Fault, 
xxxxxx is the 
hex addr of 

IK block where 
fault occured. 

RSSC 

NOT A 

Diskette in 

Insert a TRSDOS, 

SYSTEM 

Drive 0 isn't 

TRSDOS-II, or 

DISK 

a TRSDOS, 

TRSDOS-II or 

TRSDOS-16 Oper¬ 
ating System 
Diskette 

TRSDOS-16 Operating 
System diskette into 
Drive 0 
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APPENDIX B / The Configuration Command File 


Whenever TRSDOS-16 starts up or is reset, it looks for a 
file named C0NFIG16/SYS. This "configuration command file" 
tells TRSDOS-16 to link in certain extra operating system 
programs. 

C0NFIG16/SYS should be present on the primary disk device 
(Drive 0 or Drive 4). It contains these directives: 

INCLUDE RUNCOBOL 
INCLUDE DEBUG 
END 

which tell TRSDOS-16 to link in the RUNCOBOL program and the 
DEBUG program. 

You may create your own C0NFIG16/SYS file, or modify the 
existing one to meet your needs, by using EDIT16. 

The C0NFIG16/SYS file on your TRSDOS-16 diskette does not 
include the RUNCOBOL file as stated. 

SAVING THE EXISTING C0NFIG16/SYS FILE 



Before creating a new C0NFIG16/SYS file, you will probably 
want to save the existing one by renaming it. 

For example: 

RENAME C0NFIG16/SYS :0 TO DEBCOB/CFG:0 

renames the default configuration file. (The new filename 
tells you it includes both DEBUG and RUNCOBOL modules. 

After renaming the existing C0NFIG16/SYS file, you can 
create a new one. 

Since you "saved" the existing file, you can use it again. 
To do this, rename the present C0NFIG16/SYS file (if you 
want to save it) and then rename DEBCOB/CFG back to 
C0NFIG16/SYS: 

RENAME DEBCOB/CFG :0 TO C0NFIG16/SYS :0 
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TO EDIT OR CREATE CONFIG16/SYS 

Use EDIT16 to edit or create a CONFIG16 command file. 

1. Type: 

EDIT16 <ENTER> 

and the Editor's Command mode prompt will be displayed: 
C?. 

2. To insert commands into the command file, you must get 
in the Insert mode, type: 

IN <ENTER> 

The Editor will display the I? prompt, indicating that 
you are in the Insert mode. 

3. You are now ready to insert the names of the programs 
you want linked to TRSDOS-16. 

Comments may be used. They are indicated by an 
asterisk (*) in the first column. 

The key word INCLUDE tells TRSDOS-16 the 

name of the program. The syntax for the INCLUDE 

statement is: 

INCLUDE filename 

The default extension for filespec is /SYS; it is 
optional. Drive numbers, disk ID and Passwords are 
not permitted. 

Programs are loaded sequentially in memory in the order 
they are encountered in the C0NFIG16/SYS file. The 
maximum number of programs that may be INCLUDEd is 15. 

The programs must be resident on the primary drive 
(Drive 0 or Drive 4). 

The list is concluded with an END statement. 
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TRS-SO 


For example: 

* This is the Configuration File for DEBUG 

INCLUDE DEBUG 

END 

tells TRSDOS-16 to link only the DEBUG program. The 
first line is a comment and is not executed by 
TRSDOS-16 

4. When you are finished inserting, press <ENTER> to exit 
the Insert Mode. 

5. Save the file with the following command: 

SA C0NFIG16/SYS <ENTER> 

6. You now have a new C0NFIG16 command file that TRSDOS-16 
will use when it powers up or resets. 


CONFIGURATOR ERROR MESSAGES 


When the Configurator lists a line generating an error, it 
prints an error message directly underneath the line number. 
Preceding the message, it inserts three asterisks. 

In cases of certain syntax or file I/O errors, the 
Configurator also marks, with a dollar sign ($), where in 
the line the error occurred. 

For example: 

011 INCLUBE RUNCOBOL 

$ 

*** Illegal Command 

shows a syntax error in the spelling of INCLUDE. 

There are three catagories of Configurator error messages: 

A. Configuration Control File Errors 

B. Configuration Command Errors 

C. Completion Errors 
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A. Congifuration Control File Errors 

These errors are FATAL. If one of these errors occur, the 
Configurator could not properly execute the C0NFIG16/SYS 
file. TRSDOS-16 will still be displayed but certain 
defaults will have occured: 

1. No programs have been INCLUDED 

2. DEBUG is kept resident (if available) 

3. Any memory not occupied by DEBUG and the resident 
Operating System is available to the user. 

Use EDIT16 to correct the error (or create a new 
configuration file) and reset the system. 


Can't Open C0NFIG16/SYS: TRSDOS Error Code = nnn 

Look up TRSDOS-16 Error Code nnn in Appendix B and 
take appropriate action. 


Can't configure system: File C0NFIG16/SYS not proper 
format 

The C0NFIG16/SYS file is not a VLR type file. 

Can't configure system: File C0NFIG16/SYS not found 
TRSDOS-16 could not find the C0NFIG16/SYS file. 

I/O Error on File C0NFIG16/SYS: TRSDOS Error Code = nnn 

Look up TRSDOS-16 Error Code nnn in Appendix B and 
take appropriate action. 


B. Configuration Command Errors 

These errors occur when a command cannot be processed by the 
Configurator. If one of these error occurs, the 
Configurator will continue to process the command lines. 
However, the desired result of the configuration file may 
not have been accomplished. For example, an INCLUDE file 
may have been left out. 
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Can't INCLUDE program: 


TRSDOS Error Code 


nnn 


The Configurator cannot load the program because 
of an I/O error. Look up the TRSDOS-16 Error Code 
in Appendix B. 


Can't INCLUDE program: Out of Memory 

More resident programs were requested than will fit 
into user memory. 


Can't INCLUDE program: Program already configured 

This error occurs any time a program is included twice. 


Too many INCLUDED programs: this request ignored 

This error occurs if more than 15 programs are 
included. The command line that is flagged is ignored 
(treated as a comment). 


C. Completion Error 

*** CONFIGURATION ABORTED *** 

This message appears when the configurator could not 
finish processing the C0NFIG16/SYS file because of 
an I/O error. 
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ABOUT THE CONFIGURATOR 


The Configurator is invoked whenever the 68000 processor is 
initialized. It performs several important functions: 

. It determines whether the machine debugger is 

required. If not, it is eliminated from memory. 
This gives you an extra 4K of memory. 

. It initializes traps and interrupts. This 

eliminates the need to keep extra code resident 
in memory. 

. It loads in resident programs as specified in 
the C0NFIG16/SYS file. 

. It reads the AUTO file and passes it to 
TRSDOS-16 for execution. 


The Configurator is linked in at the end of user memory and 
occupies 4K of memory. Upon system initialization, it moves 
itself to the top of physical memory. This is because the 
resident programs will be loaded at low address, overlaying 
the original configurator. 

Next the Configurator begins to load the resident programs 
requested in the C0NFIG16/SYS file (i.e., DEBUG and 
RUNCOBOL). It loads these programs sequentially starting at 
the beginning of user memory and up to the beginning of 
where the Configurator has relocated itself. This 
guarantees that after loading is complete, the user has at 
least 4K of memory available (the size of the Configurator). 

After configuration is complete, the Configurator is no 
longer neccessary and is overwritten. 
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APPENDIX C / Memory Map 


BEGINNING OF 
MEMORY 

E'5000 


E'6000 


> - 

TRSDOS-16 

DEBUG 
IF LOADED 


RUNCOBOL 
IF LOADED 


BASE ADDRESS —> 


USER 

MEMORY 


BOUNDS ADDR —> 


MEMORY CHART 


User memory begins at E'5000 if the Debugger is not 
configured and at E'6000 if the Debugger is configured. 
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APPENDIX D / ASCII Character Codes 


Code 


Dec. Hex. 


00 00 
01 01 


Keyboard 


ITOTil 

SI 


02 


02 


CTRL A 


CTRL B 


03333 


03 

04 

05 

06 

07 

08 

09 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 
27 


03 


CTRL C 


04 

05 

06 

07 

08 


CTRLEJ^ 
CTRL F I 

ctrlgB 

BACKSPACE 


09 


CTRL H 


jum 


0A 

0B 

0C 

OD 


CTRL 11 
CTRLJi 

ctrTk 

CTRL L 
ENTERI 


OE 

OF 

10 

11 

12 

13 

14 

15 

16 

17 

18 
19 


CTRLM 
CTRL N 
CTRLO 
CTRL P 
CTRLQ 
CTRL R 
CTRLS 


CTRL T I 
CTRL U 
I CTRL V 


[CTRL Wj 
I CTRL x| 
CTRL Y| 


1A 


CTRL Z 


IB 


ma 


Character 


Video Display 


Turns on blinking cursor 


Turns off cursor 


Turns on steady cursor 


Backspaces cursor and 
erases character 
Advances cursor to next 
8-character boundary 
Linefeed 

Cursor to previous line 


Carriage return 

Dual routing on 
Dual routing off 


Homes cursor to upper left 


Erases to end of line 
Erases to end of screen 
Sets white-on-black 
mode 

Sets black-on-white 
mode 

Clears screen, homes 
cursor 


*001331 is always intercepted. It will never return a code 3 to the user 


program. 
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Code 

Character 

Dec. 

Hex. 

Keyboard 

Video Display 

28 

1C 

Q 

Moves cursor back 

29 

ID 

Q 

Moves cursor forward 

30 

IE 

□ 

Sets 80-character mode 
and clears Display 

31 

IP 

Q 

Sets 40-character mode 

and clears Display 

32 

20 

WM'i 'SPACE BAR 

0 

33 

21 

I 

I 

34 

22 

” 

»> 

35 

23 

# 

# 

36 

24 

$ 

■■■■■■■■■■I 

37 

25 

% 

% 

38 

26 

& 

& 

39 

27 

. t . 

* 

40 

28 

( 

( 

41 

29 

) 

) 

42 

2A 

* 

★ 

43 

2B 

+ 

+ 

44 

2C 

* 


45 

2D 


— 

46 

2E 



47 

2F 

/ 

/ 

48 

30 

0 

0 

49 

31 

1 

1 

50 

32 

2 

2 

51 

33 

3 

3 

52 

34 

4 


53 

35 

5 

5 

54 

36 

6 

6 

55 

37 

7 

7 

56 

38 

8 

■■■■■■■■■■■■ 

57 

39 

9 

9 

58 

3A 



59 

3B 

> 

i 

60 

3C 

< 

< 

61 

3D 

= 

= 

62 

3E 

> 

> 

63 

3F 

? 

? 

64 

40 

@ 

@ 

65 

41 

A 

A 

66 

42 

B 

B 

67 

43 

C 

C 

68 

44 

D 

D 

69 

45 

E 

E 

70 

46 

F 

F 

71 

47 

G 

G 
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Code 

Character 

Dec. 

Hex. 

Keyboard 

Video Display 

72 

48 

H 

H 

73 

49 

i 

1 

74 

4A 

j 

J 

75 

4B 

K 

K 

76 

4C 

L 

L 

77 

4D 

M 

M 

78 

4E 

N 

N 

79 

4F 

O 

O 

80 

50 

P 

P 

81 

51 

Q 

Q 

82 

52 

R 

R 

83 

53 

S 

S 

84 

54 

T 

T 

85 

55 

U 

U 

86 

56 

V 

V 

87 

57 

w 

w 

88 

58 

X 


89 

59 

Y 

Y 

90 

5A 

z 

z 

91 

5B 

[ 

t 

92 

5C 

CTRL-9 

\ 

93 

5D 

1 

] 

94 

5E 

A 

A 

95 

5F 

_ 

_ 

96 

60 


\ 

97 

61 

A 

a 

98 

62 

B 

b 

99 

63 

C 

c 

100 

64 

D 

d 

101 

65 

E 

e 

102 

66 

F 

f 

103 

67 

G 

g 

104 

68 

H 

h 

105 

69 

1 

i 

106 

6A 

J 

j 

107 

6B 

K 

k 

108 

6C 

L 

1 

109 

6D 

M 

m 

110 

6E 

N 

n 

111 

6F 

O 

0 

112 

70 

P 

p 

113 

71 

Q 

q 

114 

72 

R 

r 

115 

73 

S 

s 

116 

74 

T 

t 
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Code 

Character 

Dec. 

Hex. 

Keyboard 

Video Display 

117 

75 

u 

U 


118 

76 

V 

V 


119 

77 

w 

W 


120 

78 

X 

X 


121 

79 

Y 

y WMKBRM 


122 

7A 

z 

z 


123 

7B 

« 

< 


124 

7C 

■ ( : 1 

! 


125 

7D 

\ 

■■Hi 


126 

7E 




127 

7F 

HHHHB 

± 


128 

80 


1 


129 

81 


j mam 


130 

82 




131 

83 


i 


132 

84 


T 


133 

85 


* 


134 

86 


1 


135 

87 


» 


136 

88 


7 


137 

89 


i 


138 

8A 


1 


139 

8B 


j ffiHHi 


140 

8C 


* 


141 

8D 


t 


142 

8E 


4 


143 

8F 


4 


144 

90 


■ 

145 

91 


■ 

146 

92 


1 

147 93 


i 

148 

94 


i 

149 

95 

■■■■■■■■■hi 

HHlHHHBHHHHBHi 

150 

96 


■ 

151 

97 


*■* 


152 

98 


- 


153 

QQ 


■ 


154 

9A 


■ 


155 

9B 


■ 


156 

9C 


r 


157 

9D 


i 


158 

9E 


i . 


159 

QF 

C7I 


t 


160 

A0 


b 

161 

A1 


! 

162 

A2 
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Code 

Character 

Dec. 

Hex. 

Keyboard 

Video Display 

163 

A3 


# 

164 

A4 


$ 

165 

A5 


% 

166 

A6 


& 

167 

A7 


» 

168 

A8 


( 

169 

A9 


) 

170 

AA 


★ 

171 

AB 


+ 

172 

AC 


» 

173 

AD 


- 

174 

AE 



175 

AF 


/ 

176 

B0 


0 

177 

B1 


1 

178 

B2 


2 

179 

B3 


3 

180 

B4 


4 

181 

B5 


5 

182 

B6 


6 

183 

B7 


7 

184 

B8 


8 

185 

B9 


9 

186 

BA 



187 

BB 


’ 

188 

BC 


{ 

189 

BD 



190 

BE 


x 

191 

BF 


? 

192 

CO 


@ 

193 

Cl 


A 

194 

C2 


B 

195 

C3 


C 

196 

C4 


D 

197 

|C5 I 


E 

198 

C6 


F 

199 

C7 


G 

200 

C8 


H 

201 

C9 


i 

202 

CA 


J 

203 

CB 


K 

204 

CC 


L 

205 

CD 


M 

206 

CE 


N 

207 

CF 


0 

208 

DO 


P 
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Code 

Character 

Dec. 

Hex. 

Keyboard 

Video Display 

209 

D1 


Q 

210 

D2 


R 

211 

D3 



212 

D4 


T 

213 

D5 



214 

D6 


V 

215 

D7 


w 

216 

D8 


X 

217 

D9 


y 

218 

DA 


z 

219 

DB 


[ 

220 

DC 


\ 

221 

DD 


] 

222 

DE 


A 

223 

DF 


_ 

224 

E0 


* 

225 

El 


a 

226 

E2 


b 

227 

E3 


c 

228 

E4 


d 

229 

E5 


e 

230 

E6 


f 

231 

E7 


g 

232 

E8 


h 

233 

E9 


i 

234 

EA 


j 

235 

EB 


k 

236 

EC 


1 

237 

ED 


m 

238 

EE 


n 

239 

EF 


0 

240 

FO 

Unused 


241 

FI 

Unused 


242 

F2 

Unused 


243 

F3 

Unused 


244 

F4 

Unused 


245 

F5 

Unused 


246 

F6 

Unused 


247 

F7 

Unused 


248 

F8 

Unused 


249 

F9 

Unused 


250 

FA 

Unused 


251 

FB 

Unused 


252 

FC 


Moves cursor left 

253 

FD 


Moves cursor right 

254 

FE 


Moves cursor up 

255 

FF 


Moves cursor down 


Radio /hack 



244 












































































TRSDOS 16 OWNER'S MANUAL 


TECHNICAL INFORMATION 


TRS-8Q 


APPENDIX E / Graphics Codes 
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TRSDOS 16 OWNER'S MANUAL 


TECHNICAL INFORMATION 



APPENDIX F / MODEL 16 & ENHANCED MODEL II SPECIFICATIONS 


SPECIFICATIONS 

The Radio Shack TRS-80 Model 16 and Enhanced Model II are 
disk-based computer systems with two major components: 

1. A Display Console with up to two built-in, 
double-sided, double-density floppy disk drives 
(Model 16) or one built-in, single-sided floppy 
disk drive (Enhanced Model II). 

2. A separate keyboard enclosure which can be 
positioned for maximum operator comfort and 
efficiency. 

The operating system software is loaded from a system 
diskette in Drive 0 or Drive 4 by a built-in ROM "bootstrap" 
program. 


PROCESSORS 

Input/Output Processor System: 

. Z80-A based with 64K bytes of random access memory 

. Independent bus can support all the standard 
system boards 

. Emulation mode allows you to execute programs 
previously developed for the TRS-80 Model II 
without changing them first. 

Computational Processor System: 

. 68000 based with either 128K or 256K (384K or 

512K bytes on a Model 16) of RAM 
. Independent bus can support multiple bus masters 

The two processors share the computing load from the 
application programs (the Z80-A based processor performs 
input/output tasks while the 68000 based processor performs 
computational tasks). 
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VIDEO DISPLAY 

LSI Controller Chip: 

. Frees the input/output (Z80-A based) processor 

from much of the overhead required to update and 
maintain the video display. 

Four Modes: 

. Model 16: 

. green on black (normal) 

. black on green (reversed) 

. 80 characters by 24 lines 
. 40 characters by 24 lines 
. Enhanced Model II: 

. white on black (normal) 

. black on white (reversed) 

. 80 characters by 24 lines 
. 40 characters by 24 lines 

Displayable Characters: 

. Full ASCII set 

. 32 graphics characters 


KEYBOARD 

. LSI Controller frees the input/output (Z80-A 

based) processor from keyboard scan and related 
tasks 

. Located in separate case for convenience 
. Connected to Display Console via a built-in cable 
exiting the bottom front of the Console 
. Standard typewriter keys, repeat key and two 
general-purpose function keys 
. Four modes: 1) Unshift; 2) Shift; 3) Caps; 4) 
Control 


FLOPPY DISK DRIVES 
Minimum: 

. Model 16: One (if system contains a hard disk) or 
two built-in 8" double-sided floppy disk drives 
. Enhanced Model II: One built-in 8" single-sided 
floppy disk drive 
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Maximum: 

. Model 16: Two built-in and two external 8", 
double-sided floppy disk drives 
(Disk Expansion Unit needed for two external 
drives) 

. Enhanced Model II: One built-in and three 
external 8" single-sided floppy disk drives 
(Disk Expansion Unit needed for three external 
drives) 

Storage Capacity: 

. 1,256,704 bytes per double-sided diskette (for 

User Data Capacity, see Operating System Manual) 

. 625,920 bytes per single-sided diskette (for User 

Data Capacity, see Operating System Manual) 

Diskette Organization: 

. 154 tracks per double-sided diskette, 77 tracks 

per single-sided diskette 

. 32 (0-31) sectors per track — will vary with 

operating system software. See TRSDOS Reference 
Manual, Technical Information section for more 
details. 

. 256 bytes per sector (except track 0 which has 128 

bytes per sector) — varies with operating system 
software. See TRSDOS-16 and the TRSDOS/Model II 
Reference Manuals, Technical Information sections 
for more details. 

Data Transfer Rate: 

. 500,000 bits per second (except track 0 which has 

250,000 bps) 

Required Media: 

. Model 16: Radio Shack Double or Single-sided, 8" 
Floppy Diskettes 

. Enhanced Model II: Radio Shack Single-sided, 8" 
Floppy Diskettes 

Preventative Maintenance Interval: 

. Typical usage (3,000 Power-on hours per year): 
Every 8000 Power-On Hours 

. Heavy usage (8,000 Power-on hours per yeat): 

Every 5000 Power-On Hours 
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Diskette Life: 

. 3.5 million passes per track 

. Usually limited by improper handling. Follow 
handling recommendations for maximum use. 


POWER SUPPLY 

Power Requirements: 

. 105 - 130 VAC, 60 Hz 

. 240 VAC, 50 Hz (Australian) 

. 220 VAC, 50 Hz (European) 

. Grounded outlet 

Maximum Current Drain: 

. 2.0 Amps 

Typical Current Drain: 

. 1.5 Amps 

OPERATING TEMPERATURE 

. 32 to 110 degrees Fahrenheit 

. 0 to 43 degrees Centigrade 


PERIPHERAL INTERFACES 
Standard: 

. Serial port A (RS232-C) 

. Serial port B (RS232-C) 

. Parallel input/output channel, for connection to 
TRS-80 standard parallel interface line printers 
. Floppy disk input/output channel for connection of 
a Disk Expansion Unit 

Optional: 

. Hard Disk Drive Interface 

. ARCNET Interface 

. Graphic Board 

Serial Interface 

Two Channels 

. Channel A allows asynchronous or synchronous 
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TECHNICAL INFORMATION 


transmission. 

. Channel B allows asynchronous transmission only. 
. Both conform to the RS-232-C standard. 

. Both use the DB-25 connectors on the back of the 
Display Console. 

The DB-25 connector pin-outs and signals available are 
listed below. 


CHANNEL A CHANNEL B 


STANDARD PIN # 

RS-232C SIGNAL 
I/O TRANSMIT S.E.T. 15 

GROUND 1,7 

RECEIVED DATA 3 

RECEIVER CLOCK 17 

TRANSMIT CLOCK 24 

DATA SET READY 6 

CLEAR-TO-SEND 5 

CARRIER DETECT 8 

TRANSMIT DATA 2 

REQUEST-TO-SEND 4 

DATA TERMINAL READY 20 


STANDARD PIN # 

RS-232-C SIGNAL 
GROUND 1,7 

RECEIVED DATA 3 

RECEIVER XMITTER CLOCK 17 

DATA SET READY 6 

CLEAR-TO-SEND 5 

CARRIER DETECT 8 

TRANSMIT DATA 2 

REQUEST-TO-SEND 4 

DATA TERMINAL READY 20 
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TRS-BO 


Parallel Interface 

. Connection to a line printer via the 34-pin 
connector on the back panel of the Display 
Console. 

. Eight data bits are output in parallel. 

. Four data bits are input. 

. All levels are TTL compatible. 

The connector pin-outs and signals available are listed on 
the next page. 
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SIGNAL 

STROBE 


DATA 0 

DATA 1 
DATA 2 
DATA 3 
DATA 4 
DATA 5 
DATA 6 
DATA 7 

ACK* 


BUSY 

PAPER 

EMPTY 


SELECT 


PRIME* 


FAULT* 


GROUND 


NC 

♦These 


FUNCTION 

1 microsecond pulse to clock 
the data from processor to 
printer 

Bit 0 (lsb) of output data 
byte 

Bit 1 of output data byte 
Bit 2 of output data byte 
Bit 3 of output data byte 
Bit 4 of output data byte 
Bit 5 of output data byte 
Bit 6 of output data byte 
Bit 7 (msb) of output data 
byte 

Input to Computer from 
Printer, low indicates data 
byte received 
Input to Computer from 
Printer, high indicates busy 
Input to Computer from 
Printer, high indicates no 
paper — if Printer doesn't 
provide this, signal is 
forced low 

Input to Computer from 

Printer, high indicates 

device selected 

Output to Printer to clear 

buffer and reset printer 

logic 

Input to Computer from 
Printer low indicates fault 
(paper empty, light detect, 
deselect, etc.) 

Common signal ground 


Not connected 


PIN 

1 


3 

5 

7 

9 

11 

13 

15 

17 

19 


21 

23 


25 

26 

28 


2,4,6,8,10,12,14, 

16,18,20,22,24, 

27,31,33 

29,30,32,34 


signals are active-low. 
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APPENDIX G / SVC Quick Reference List 


NAME 

DESCRIPTION 

NO. 

ACTL 

Control Channel A 

100 

ARCV 

Channel A Receive 

96 

ATX 

Channel A Transmit 

97 

BCTL 

Control Channel B 

101 

BRCV 

Channel B Receive 

98 

BTX 

Channel B Transmit 

99 

CLOSE 

Terminates output to specified file. 

42 

CLOSEF 

Terminates output to all open files 
except OPENDO file 

133 

CLRXIT 

Clear user memory and jump to TRSDOS-16 
Ready 

257 

CURSOR 

Position cursor 

10 

DATE 

Returns the real-time (time/date) 

45 

DEBUG 

Load the Debugger 

259 

DIRRD 

Allows a specific record in a FLR file 
to be read. 

35 

DIRWR 

Allows a specific record in a FLR file to 
be read. 

44 

DISMOUNT 

Logically disconnect a MOUNTed disk device 

139 

DOSCMD 

Execute TRSDOS-16 command and return 
to TRSDOS-16 Ready 

270 

DUMP 

Writes a 68000 format program file from 
68000 memory. 

130 

ERRMSG 

Returns an 80-byte descriptive error 
message for the requested error number 

52 
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NAME 

DESCRIPTION 

NO. 

ERROR 

Causes the error message refered to 
by ERROR NUMBER to be printed 
on the video display. 

39 

EXECUTE 

Execute program. 

263 

HLDKEY 

Enable / Disable HOLD key. 

29 

JP2DOS 

Jump to TRSDOS-16 Ready. 

264 

KBCHAR 

Strobes the keyboard and returns with or 
without a character. 

4 

KBINIT 

Initializes the keyboard input driver. 

1 

KBLINE 

Inputs a line from the keyboard into a 
a buffer and echoes the line to the 
display. 

5 

KILL 

Deletes the specified file from the 
directory. 

41 

LOAD 

Loads a 68000-format program into the 
user memory. 

131 

LOCATE 

Returns the number of the current record, 
(i.e. the last record accessed) 

33 

MOUNT 

Logically connects a disk device 

138 

MOVBUF 

Retrieves and stores an 80-byte buffer 

267 

OPEN 

Handles both the creation and opening of 
files. 

40 

OPENDO 

Opens and creates a special file not closed 
by CLOSEF 

140 

PRCHAR 

Sends one character to the Printer. 

18 

PRCTRL 

Lets you select various printer options. 

95 

PRINIT 

Initializes the printer driver 

17 
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® 


NAME 

DESCRIPTION 

NO. 

PRLINE 

Sends a line to the Printer. 

19 

READNX 

Reads the next record after the current 
record. 

34 

RENAME 

Changes the name and/or extension of a file 

47 

RESET 

Same as pressing the RESET switch 

129 

RS232C 

Initialize RS-232C Channel 

55 

SETBRK 

Enable / Disable the BREAK key 

269 

SETTRP 

Set or remove trap vectors 

266 

UNLOCK 

Unlocks a specified record 

136 

VDCHAR 

This routine outpus a character at the 
current cursor position. 

8 

VDINIT 

Initialize the Video Driver 

7 

VDLINE 

Writes a buffer of data to the display 

9 

VERSION 

Get version of Operating System 

137 

VIDKEY 

Sends a prompting message to the display 
and then waits for a line from the keybd. 

12 

WRITNX 

Writes the next record after the last 
record accessed, (i.e., sequentially) 

43 
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INDEX 


ABS 

Access Password 
ACTL 

Addresses 

Base Address 
Bounds Address 
Buffer Address 
Dump Address 
High Bound Address 
Low Bound Address 
Parameter List Address 
Start Load Address 
Transfer Address 

ALL 

Alternate Directory 

APPEND 

ARCV 

ASCII 

Character Codes 
Text File 
Assembler 
ATTRIB 
ATX 
AUTO 

Auto File 
Auto Line Feed 
Auto Sign-On 

Background Printing 
BACKUP 

Base Address 

BASIC 

Baud Rate 

BCTL 

BLOCK 

B00T16 TRSD0S16/SYS 
Bounds Address 
Braces { } 

BRCV 

BRCV 

<BREAK> 

Break Character/Sequence 
BTX 

Buffer 

address 

BUILD 

Byte 

Byte-Offset 


Capture-File 

Character Transmitted Status 


Page 


27,34, 48, 52, 71, 74 
15 

79, 122, 129-130 

105, 106,107, 238 
238 

128, 212 
156 
170 
170 

177, 199 
170 

170, 202 
48, 72, 74 
53 

25, 29, 51 
79, 122, 131 
59, 84, 145 
239-244 
116 
105 

15, 25, 29-31, 51 
79,122, 133-134 
12, 25, 31-32 
237 

187, 188 
88, 92 

82, 185 

25, 32, 68, 73 


105 

, W, 

107, 

238 

65 




79, 

CO 

00 

Ul 

,86 


79, 

122, 

135- 

136 

123 




12 




105 

, 107, 

238 


27 




79 




122 

, 137 



12, 

64,87 

1 

kO 

164, 202 

87, 

88 



79, 

122, 

139- 

140 

114 

, 127, 

155 

, 175 

128 

, 212 



76 




108 

, 112, 

123 


123 

, 124, 

126 

, 127 

82, 

83 



133 

, 139 
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INDEX 


Page 


CLEAR 

CLOSE 

CLOSEF 

CLRXIT 

CLS 

COBOL 

Codes 

Access Code 
ASCII Character Codes 
Communications Status 
Code 

Creation Code 
Error Code 
Graphics Code 
Column 

Command File 
Command Syntax 
Comment 

Communications Status Code 

Compilers 
Completion Errors 
Configuration 
Errors 

Command File 
Configurator 

Error Messages 
C0NFIG16/SYS 
COPY 
CREATE 
Cylinders 

Data Files 

DATASET 
DATE 
DATE SVC 

DB-25 Connector Pin-Outs 

(DC) Date Created 

DEBUG 

D ^bugger 

DELETE 

Diagnostics 

DIR 

Direct File Access 
Directory 

Alternate Directory 
Primary Directories 
Space Formula 
DIRRD (Direct-Read) 

DIRWR (Direct-Write) 


25, 33 

122, 141 

122,142, 180 

122, 143 

18, 25, 26, 33 

35 

177, 180 
239-244 

130, 131, 133, 135, 

138, 139 
177, 181 
177 
245 
144 

18, 105 
26-28 
27 

130, 131, 133, 135, 
138, 139 
29 

234,236 

105 

234,235 
12,147, 232 

234-236 

12, 232, 233,237 
25, 27, 34, 35, 51 

25, 35,36,51, 113 
108 

64, 65, 66, 69, 90, 91 
97 

72, 74, 75 
18, 25, 36 
127, 145-146 
250 

74, 77 

26, 122, 147, 232,234 
147, 238 

69 

110 

17-20, 25, 31, 37-39 
119 

14, 58,169 
110,111 
110,111 
110 

119, 121, 122, 149-150 
206 

119, 121,122, 

123, 151-152 
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INDEX 


Page 


Disk 

6 


Disk capacity 

Double-Sided Diskette 

108 


Hard Disk 

108, 109 


Single-Sided Diskette 

108 


Diskette 

6 


Diskette Swap 

61 


Disk Files 

14, 18, 19, 

48, 57, 


63, 81, 82, 

113, 118, 

Disk I/O 

141 

128 


disk name 

16, 38 


Disk Organization 

108 


Disk Read/Write Mechanism 

57 


Disk Sectors 

56 


Disk Space Allocation 

112 


Double-Sided diskette 

112 


Hard Disk 

112 


Single-Sided diskette 

112 


DISMOUNT 

21, 25, 39- 

40, 61, 122, 

(DM) Date Modified 

153, 173 

74, 77 


DO 

25, 28, 40- 

41, 51 

Do-file 

18, 19, 28, 

32, 142, 

DOSCMD 

143, 163 
122, 155 


Double-Sided Diskette 

32, 52 


drive 

15 


DRIVE 

41-46 


Drive Settings 

RATE 

42, 43, 44 


DETECT 

42, 43, 44 


NODETECT 

42, 43, 44 


WAIT 

42, 43, 44 


NOWAIT 

42, 43, 44 


OFFLINE 

42, 45, 46 


ONLINE 

42, 45, 46 


DUAL 

190 


Dummy Modes 

56 


Dummy Output Mode 

187, 188 


DUMP 

46-47, 51, 

97, 122, 

Dump Address 

156-157 

156 


Editor 

14, 40, 105 


EDIT16 

14, 18, 40, 

232, 233 

Emulation Mode 

246 


Emulators 

205 


ERRMSG 

122, 127, 158 

ERROR 

122, 126, 159 

Error-Code 

124 


Error Conditions 

66, 139 


Error Messages 

158, 221 
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INDEX 



Page 

Boot Errors 

Operating System Errors 
Application Program Errors 

EXEC 

EXECCJT 

extension (/ext) 
extents 

221, 228 

221, 222 

221 

26, 47-48 

122,160 

14, 10 

57 

FCOPY 

FCOPY DIR 

Fields 

File Access 

File Allocation 

Dynamic Allocation 
Pre-Allocation 

File Fragmentation 

File Identification Number 

17, 18, 25, 48-50 

49 

145 

122 

113 

113 

56-57 

124, 125-126, 141, 150, 
172, 177-178, 180, 182, 
194, 206, 217 

filename 

FILES 
filespec 

First-In, First-Out buffer 
(FIFO) 

Fixed length Record (FLR) 

14, 38, 70 

50-51 

14, 16 

131, 137 

29, 38, 63, 91, 116, 

Flags 

Wait For Character 

Character Present 

Returned Character 

FLOPPY 

Floppy Diskette 

Single-Sided 

Double-Sided 

Double Density 

Swap 

Floppy Disk Drives 

Latch 

Push button 

Thinline 

Floppy Disk System 

FORMAT 

FORMS 

Format Options 

Parameters 

Switch Options 

FREE 

Function Code 

119, 149, 151, 172 

138, 139 

164 

164 

164 

51- 52 

71, 73, 108 

108 

108 

108 

173 

41, 42, 43, 60, 247-249 
42-45 

42-45 

42-45 

11 

52- 54, 68 

54-56, 86, 92 

54- 55 

55 

55- 56 

56- 57 

122, 124, 126 

Graphics Code 

245 

Hard Disk 

Drives 

5, 73, 112, 153 

42 
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INDEX 


Page 


System 

HELP 

Hexadecimal Codes 
Hexadecimal Number 
HLDKEY 
<HOLD> 


Hr 

58 

67 

47 

122 

161 


73 


161-162 


Illegal Opcodes 

Indexed Access Files(ISAM) 

INDirect (IND) 

Input Buffer 

Input/Output Processor System 
Instruction Address 
Interactive Terminal Mode 
Error Messages 
P 
0 
F 

DATA CARRIER LOST 
DATA CARRIER RESTORED 
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PATCH 

63-66 

Patch Level 

214 
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Normal/Reverse Switch 
Syntax 
SYS 

System Commands 
System Diskette 
System Files 
System Trap 

T 

TERMINAL 

Error Conditions 
P 
0 
F 

DATA CARRIER LOST 
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BREAK SEQUENCE RECEIVED 


119, 122-123, 126-127 

123-126 

125-126 

124 

253-255 

21 

210 

210 

58 

37, 49,50, 69, 72, 74 

12, 29-103 

32 

37 

127 

83- 84 

84- 101 
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Tracks 

108, 

110-112 

Transfer Address 

156 


Transparent Mode 

56, 
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